home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / wchslink.zip / WCHS.DOC < prev    next >
Text File  |  1992-01-12  |  9KB  |  193 lines
  1. Wildcat-HSlink utility.  (c) 1992  Karl Schneider
  2.                                    8505 Woodwick Ct.
  3.                                    Tampa, FL 33615
  4.                                    813-884-9661 voice days/eves
  5. Jan 12, 1992                       "   "   "    BBS midnight to 0700 EST
  6.                                                 14.4 HST
  7.  
  8.  
  9. ------------------------------------------------------------------------
  10. Shareware release, 1-12-92:  This version ONLY WORKS WITH COM1 AND COM2!
  11. REGISTERED versions (available soon) will support COM3 and up, will
  12. be DESQview aware *, and will offer a few more features.  Note, however,
  13. these programs are NOT CRIPPLED, have no 'time-bombs', and do not
  14. write any 'secret' files or write into any existing Wildcat or other
  15. program files.
  16.  
  17. * This version will run fine in DV, but is not OPTIMIZED for it.
  18. -------------------------------------------------------------------------
  19.  
  20. The programs in this archive will enable you to use HSLINK (c) for
  21. regular (one-way) AND Bidirectional transfers to and from your Wildcat
  22. 3.x+ BBS.  The implementation is less than 'perfect' in that it requires
  23. your users to perform one additional step after doing a two-way
  24. transfer.  It is, however, not complex, and the users are instructed
  25. how to go about it by way of the enclosed programs.
  26.  
  27. Please read these instructions carefully---the procedure is NOT
  28. complicated, but it MUST be followed properly.
  29.  
  30. HSLINK is a widely distributed and frequently updated Beta of a bi-
  31. directional (as well as one-way) file transfer protocol written by
  32. Samuel Smith.  The latest version as of this date, is as
  33. far as I can tell, HSLK10E4.  If you plan to offer this protocol, be
  34. sure to try to keep the latest versions installed, as well as avail-
  35. able for download for your users.
  36.  
  37. First, let me explain how your users will do a BiDirectional file
  38. transfer.  The first step is just as explained in the HSLink Documents;
  39. that is, the user picks the files he wishes to DOWNload from the Files
  40. Menu as usual, chooses [H]slink (or whatever letter you have set up
  41. in Makewild), and when Wildcat instructs him to begin the download,
  42. he initiates an UPLOAD using HsLink from his usual COMM program, after
  43. telling it what files to SEND to your BBS.
  44.  
  45. HSLINK will perform the transfers, and when it is finished, your SH.BAT
  46. file (or whatever you name it) will call the program WCHSD.EXE which
  47. will check to see if HSLINK RECEIVED any files (UPloads to your sys-
  48. tem, that is)...and if so, will instruct the user to COMPLETE THE
  49. OPERATION by entering [U] from the Files menu when it reappears, then
  50. selecting HSLink and WAIT for the prompts: 'Do you wish to password
  51. protect this file', 'Enter Description', and so forth.  He will be
  52. told NOT TO INITIATE ANOTHER UPLOAD AT THAT TIME - ONLY TO WAIT FOR
  53. THE PROMPTS ASKING FOR THE FILE INFORMATION!
  54.  
  55. You will see this same message on your BBS screen.  The user will
  56. have 30 seconds to 'press a key', which should be sufficient to under-
  57. stand the instructions.  If he does not press a key, Wildcat will
  58. reload anyway after 30 secs.
  59.  
  60. After descriptions, etc. have been entered for all files, WILDCAT will
  61. go through the normal SCANFILE testing routine for the uploads, just
  62. as in a normal UPload.  (Where you have something like ZIPLAB (c),
  63. CATSCAN (c), etc.  Note that AUTODESC, my automatic-description in-
  64. serting program, functions properly in this procedure).
  65.  
  66. Here are some potential glitches:
  67.  
  68. 1.  The user attempts to UPLOAD the files again after the HSLINK
  69.     transfer is complete.  This will result in him sending binary
  70.     data which will probably cause WILDCAT to do who knows what.
  71.     You have all seen this...different menus coming up, etc. etc...
  72.     This will not cause any serious problem, but the uploads may
  73.     be lost, have wrong descriptions, or the user may just get
  74.     frightened and hang up.  I suggest posting a bulletin or Hello
  75.     screen with some instructions for doing HSLink transfers.
  76.  
  77. 2.  The user fails to complete the transfer procedure...that is,
  78.     does not go to Upload and enter the information for the files.
  79.     If he logs off before doing this (actually, he can exit the FIles
  80.     Menu and do other things, then come BACK and do the Upload just
  81.     fine), the HS uploads will be moved into a designated 'hold'
  82.     directory and a note will be put into the appropriate ACTIVITY.00x
  83.     log file notifying you that he did not complete the procedure.
  84.     You can do whatever you like with the uploaded files afterwards.
  85.  
  86. ------------------------------------------------------------------------
  87. OK....now how to set all this up?
  88.  
  89. Let's take it step by step -- 5 steps:
  90.  
  91. 1.  Starting from your Wildcat HOME directory, in DOS, type the
  92.     following:
  93.  
  94.     md wcwork\node#\ep\temp
  95.  
  96.     (replace the '#' above with the NODE NUMBER you are installing
  97.     this package in)
  98.  
  99.     If you are installing it in more than 1 node, repeat the above
  100.     command with the appropriate node numbers.
  101.  
  102. 2.  First, put all 4 of the .EXE files in this archive (WCHSD.EXE,
  103.     WCHSU1.EXE, WCHSU2.EXE, and WCHSCK.EXE) someplace in your DOS
  104.     PATH.
  105.  
  106. 3.  Be sure your WCNODEID=   Environment variable is properly set
  107.     for the node you're working with. (page 278 in my manual)
  108.  
  109. 4.  Set up HSLINK as an External Protocol in Makewild.  I use SH.BAT
  110.     as the Download (Send) batch file, and RH.BAT for UPloads (Receive).
  111.     Samples are included in this archive.  Make them EXACTLY AS SHOWN
  112.     in the included examples except as noted below. Here are copies:
  113.  
  114. --------------------------------------------------------------------------
  115. REM THIS IS SH.BAT
  116. REM download from Wildcat 3.x+
  117. HSLINK -P%2 -E%4 -A -R -HS -NV -Utemp %5
  118. if errorlevel 1 goto bad
  119. goto ok
  120. :bad
  121. copy d:\wc30\all.ok transfer.bad
  122. goto end
  123. :ok
  124. wchsd %1 %2
  125. :end
  126. --------------------------------------------------------------------------
  127. You may need to change the path in the 7th line ('copy d:\wc30....')
  128. depending on your WC setup drive\dir, etc.  Check the HS Docs for
  129. info on the HSLINK command line parameters.
  130.  
  131. ===========================================================================
  132.  
  133. REM THIS IS RH.BAT
  134. REM UPload to Wildcat 3.x+
  135. wchsu1
  136. if errorlevel 1 goto skip
  137. hslink -P%2 -E%4 -A -R -HS -NV -Utemp
  138. :skip
  139. wchsu2
  140. ----------------------------------------------------------------------------
  141.  
  142. The only thing you may need to change here are possibly some of the
  143. HSLINK command line parameters.  Refer to the HS Docs for further info.
  144. ===========================================================================
  145.  
  146. 5.  Create or edit a POSTCALL.BAT file, in your WC HOME DIRECTORY to
  147.     contain the following line:
  148.  
  149.     wchsck c:wc\hold
  150.            ^^|^^^^^^
  151.              This is the drive\directory where UNCOMPLETED HSLINK
  152.              UPLOADS are to be MOVED to.  A note in your ACTIVITY.00x
  153.              file will inform you when this is done.  If the directory
  154.              does not exist, WCHSCK will create it for you.
  155.  
  156. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  157.  
  158. Regular Downloads and Uploads (Non-Bidirectional) are handled in
  159. the normal way...no extra steps are required for the user.
  160.  
  161. In summary, the only thing different the USER is required, is:
  162. After doing a BIDIRECTIONAL transfer, he needs to go to [U]pload
  163. from the [F]iles Menu, select [H]Slink, and simply WAIT (only a few
  164. seconds) until Wildcat asks for the 'password protect', 'Description',
  165. etc.
  166.  
  167. No special procedures are required for you, the SYSOP, other than
  168. monitoring your 'hold' directory for 'uncompleted' files, and possibly
  169. communicating with the uploader to explain the correct procedure.
  170.  
  171. This is the first release of this package.  I have tested it on my
  172. system, and so far have not found any problems, but as with any
  173. software that must run in many different environments, some bugs are
  174. likely.  I make no warranties that these programs will perform properly
  175. in all installations, and welcome any bug reports or suggestions.
  176.  
  177. REGISTRATION:
  178.  
  179. These programs may be used for a reasonable period not to exceed 30
  180. days from their installation for evaluation.  If you continue to use
  181. them afterward, a $10 registration to the above address is required!
  182. A payment of $25 or more will constitute registration to this package
  183. PLUS ALL of my other WC3 utilities!  Registration of course entitles
  184. you to full phone/bbs support and even customization you may wish,
  185. within reason.  Thank you!
  186.  
  187. -eof-
  188.  
  189.  
  190.  
  191.  
  192.  
  193.